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COPYRIGHT NOTICE 


(c) Copyright. 1985 PAUOVILLE 
All Rights Reserved 


| the software program, package design, and instructional 3 
iso@material are reserved by RAUOVILLE. These items are intended 
for use by the original oxnerconly. Excepk for personal use, 
produced in any medium, or for any other 


they my not be re ; 
he written permission of BAUDVILLE. 


application, without 


WARNING: THIS SOFTWARE PROGRAM AND MANUAL ARE BOTH PROTECTED 
py U.S. COPYRIGHT LAW. UNAUTHORIZED REPRODUCTION AND/OR SALES 


eo &: AN 
RY nay RESULT IN CRIMINAL, PENALTIES. COPYRIGHT IHFRINGERS MAY 


ALSO GE SUBVECT TO CIVIL LIABILITY. 


LIMITED WARRANTY 


BAUOVILLE warrants to the original purchaser only that the 
diskette on which the program is recorded will be free of 
defects for a period of ninety (90) days following date of 
purchase. If a defect occurs during this period, BAUDVILLE 
dated proof of purchase with the diskekte. 


The software program and the instructional and reference 
materia!s are sold "AS IS" without warranty, either express 
or implied, including, but not limited to the Implicd 
. warranties of merchantability. The entire risk as to the 
results and performance of this software program.is/assumed 
ee / ‘ 


by you. ae caps, 
Some states do not alttow the exclusion of implied warranties, 


$0 the above exclusion may not apply to you. This warranty 
€ gives you specific legal rights and you may also have other 


2 rights which vary from stute te state. BAUDVILLE’S Yiability © 


shall not in any case exceed the purchase price “or the 
software claimed to be defective.: #* 
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will replace the diskette without charge providing you send a~ 
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TOOLKIT FEATURES aa 
bss HOVIEDISK - Create a disk that will boot and run your 


"JAKE 1 program and have. some experience creating Snapshots. 
Actors, Scenes, Backgrounds, and Hovies. It fis also assumed 


_ understand how hi-res graphics» 
“computer: After ally this Is @ “progranmer’s” toolkit. 


winds ie 
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The TAKE | PROGRAMHER’S TOOLKIT lets you put the power of 


_ TAKE) animation and graphics in your own programs. It is 
designed to be easy enough.for the novice BASIC progranmer, 


yet Flexible and powerful enough for the most serious 
applications. be: ; C | 


movie automatically without the TAKE | program disk. ‘ 
This ts ideal for making presentations and demo disks. 


am “preperation 
gee eee  decaiiacdaiaanmaune ee 


* HOVIEDISK PLUS - Create a disk that will boot and run 
amovie and then run your BASIC program. All of the 
TAKE | projector features are available in your program 
through the TAKE | TOOLKIT BASIC ampersand routines 
which are installed when the HOVIEDISK PLUS is booted. 


PROJECTOR MODULES - If you wish to use the TOOLKIT 
features outside the MOVIEOISK environment, separate 
projector modules are provided that: run under 00$3.3 

in both 46K and 64K machines. A machine language 
projector module is also provided. Each of the modules 
is fully relocatable to give you maximum flexibility. 
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BACKGROUND DECODER - The Background files created with 
TAKE | are standard hi-res screens that are specially 
‘compressed to take up much less space on the disk. The 
background decoder module {is an ultra-fast wpcture i 
unpacker you can use in your Own Progr any 

A 


In addition, the TAKE | TOOLKIT disk contains fully 


commented example programs that ii gftrate how to use the 
routines in your own programs. ery effort has been made to 


make the routines as compack apd efficient as possible 
without sacrificing perf r ec. The TAKE 1 TOOLKIT BASIC 


comnands expand Applesof SIC into a high-performance | 
graphics and animati gdgage. | ee i 
») | oe yo ae : | ae 


“LEARNING TO USE THE TOOUKIT | al 


3 
rn 


This manual assumes that you ere already Familiar with the 


“that. you have 2 working knowledge of BASIC syntax and oe 
hics is imolemented on the Apple I). 
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re tit oreuenly t bake sone. time to learn how to use the 


OOLKIT effectively. 
ntire manual beforc attempting any programming just to get 
ee! for how the system works. Chapter. 2 teils you how to 


create a MOVIEDISK. Chapter. 3. covers some programming and 


‘Chapters 4 and 5 describe the TOOLKIT DOS. and TOOLKIT BASIC 
‘onnands in detail. Chapter 6. has program examples to show 


can be accomlished with just. a few lines of BASIC.: The 
“cumbersome PEEKS, POKEs. and CALLs usually required for 

animated graphics have been virtually eliminated In TOOLKIT 
“BASIC syntax. There are even “smart” file loading commands 


pendixes at the end of ‘the manual. They contain some. 
bortant information about memory maps, . zero page usage, 


Sisk may be copied with any standard copy. program Including 
2S the DISK COPY option on the TAKE | DISK UTILITIES. It is 
aP-recommended that you use & backup copy as your. working disk 
e and keep the original put away where it cannot be damaged. 


we wnile you are making the backup copy, take a moment to read 


bn the copyright notice and license agreement at the beginning 


“of this manual. You will probably be finished reading before 


Tl the drive stops spinning. Your registration number is 
encoded» into each. TOOLKIT projector module and you WILL be 
pele. tlable for eny unauthorized use or distribution of the 


Ge 
a 


/ TOOLKIT as soon as they are eye eet. We welcome any 
: “suggestions for improvement ique applications of our 
“products, If you have atest In or problem regarding the 


‘and your own resources: beFore ‘calling for assistance. 


iro. product development. IF you must call, please have 
‘yo cr. registration number Jandy and your problem clearly © 

Lo a if pee) Olere have, your computer up. and running 

ee aa “a : 


You should carefully read through the - 


: echnical cGhcepts. like page-Flipping. and sprite animation, | 


. Snow the commands are used. You will find that a great deal 


that help you manage menory efficiently. Don’t overlook the 


buffer locations, and the machine. language projector module. 


“The TAKE 1 TOOLKIT. program Site not copy mrotected.. the. 


yaudvilte has a reputation for exce! lenty@Paduct sinpohe 
eid will continue to improve and develo a\ew batece For the 
“JAKE | TOOLKIT. You will be informe: gpf any updates in the 


“TOOLKIT, make sure you Rav cJ horoughly ‘researched the manual. 
‘ egal program disk! Siecle lene 
=Telephone support {s expensive and takes valuable time away | AREA MCannnasensasaneanenaeesesecersieeenestsensenede 


' copy: ‘the TAKE 1 movie Files to. the HOVIEOISKs® Use the’ OSM 48 


Make -sureiyou copy. all! ‘of: ‘the scenes, actors,: -backgrounus ¢: 
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MAKING A MOVIEDISK 
o out 

‘There are two types of MOVIEDISKS. Cne type will boot and 
run a TAKE | movie in a continuous running loop. This allows 
you to create movies and demo disks that run without using 


“the TAKE | program. The second type of MOVIEDISK will boot | 4 


and run.a movie and then run your BASIC program with the 


enhanced TAKE 1 TOOLKIT BASIC. The boot-up movie can be 


anything from a simple one-frame title screen to an. elaborate 
multi-scene Film, f 


To make a HOVIEDISK, boot up the TAKE 1 TOOLKIT program ee 
disk and select MOVIEDISK FORMATTER from the main menu. The at 
disk will spin for a few moments and you will see the ; 
MOVIEDISK FORMATTER menu with the following options: 


=~ eemeone 


HOVIEDISK - CONTINUOUS RERUN 
MOVIEDISK PLUS BASIC PROGRAM 
EXIT TO BASIC 


Use the arrow keys and [RETURN] to select which type of 
HOVIEDISK you want to format. You will be prompted to type 
the name of the movie that will run when the disk is booted is 


up: ! 
7 : : ) | 


NAME OF MOVIE: HV. 


If you are formatting a MOVIEDISK PLUS, you will then be 


‘prompted to type a name for the BASIC program that follows 


the cadet 


NAHE OF PROGRAM: oO. art 
ee 5 las I ae 
Yau wilt be agen AX , GOP Manes are entered correctly. j 


‘Remove the TAKE | TOOLKIT program disk | 
Nesert the disk te | ie Matlacha Press 


; ; Aries oi 
eunnee aivnvanvesesensavencevensessovccnsaveceneseues, ee 


ae WARNING - Formatting a disk will destroy. any files metas eee 
* that were previously on ‘ft, Hake sure you pen t 
° accidently format “a valuable data disk oc | 


eae : mie 
Ayr ee ire i i ‘eg ch 


* 4 seen ? Pn : wit ae y ts ohn rhs ig 


en, the. ‘Slsk: haa pve Vorpatted you widr stint: pend: nes 


‘UTILITIES | ‘on. ‘the TAKE 1) ‘program: disk to copy’ ‘these Files. 


and character sets” required to run ‘the movie.” “The ne HECK ed + 
at ; ; Pde! eB Be 2 oor ae + i ee: <2 


eats wigs ; ee mi 
Vee eee to : Se EE, ats 
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“WOVIE function on the CISK UTILITIES program will examine 

your MOVIEDISK to let you know if all of the necessary files 
are there. If one of these files is missing when a MOVIEDISK 
is booted, a FILE MISSING error message will appear with the 


name of the missing file. 


i If you are making a MOVIEDISK PLUS, you will also have to 
©. save your BASIC program to the MOVIEDISK. If the disk does 
mot contain a BASIC program. with the mare specified during 
Pts formatting, a@ FILE NOT FOUND error message will appear after 
the movie is run. 


f A formatted MOVIEDISK is a lot like an initialized 0083.3. 
: ‘disk. Files canbe saved, edited, deleted, locked, etc, You 

= gan have several BASIC programs and movie files on one disk 
¥ you are only limited by the available disk space). You can 

eye format the MOVIEDISK before making your movie. Just use 

e the formatted MOVIEOISK as a data disk. The only thing to 

~ ‘consider here is that the boot-up movie name cannot be | 
a changed once the MOVIEDISK is formatted. Ba 

eo ae 

a -— 

bs HI-RES OR TEXT SCREEN EXIT FRON THE MOVIE a 

ae When you are booting up a MOVIEDISK PLUS, Gos have a 

oe choice between leaving the last frame of the*movie displayed 


in hi-res or switching te a blank text screen while the BASIC 
program is loading. if there 4s no fadesput in the last 
scene af the movie, the hi-res screens)! remain on during 
a the BASIC progagm load and run. If. there is a fade-out in 
“the last scenes the display will swith): § ¢O a blank text 
screen during the BASIC’ oe ORGS pe 


is. - * . Ls 
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PROGRAKMING WITH THE TOOUKIT 


‘When you boot up the TAKE 1 TOOLKIT. disk or a TOOLKIT 3 
MOVIEOISK, an extended set of Programning, commands are ; a 
installed which are accessed From NASIC using the ampersand 
(8) command. These New commands lovuk a lot ftike normal BASIC 
comnands but allow the programmer to. use the hi-res graphics 
and animation capabilities of the TAKE 1) scene projector. in 
addition, there are conmands that perform functions that .. 
usually require the use of cumbersome PEEKs, POKES, and CALLs 
from Applesoft BASIC. Consider the Following Applesoft BASIC 
program: 


10 POKE-16302,0:POKE-16297,0:POKE-16304,0 


This-one line program will display the hi-res graphics 
screen in a full-screen mode. Now look at the equivalent 
TOOLKIT BASIC program: 3 


10 AFULL : SVIEW 


The TOOLKIT commands are much easier to ee and read, 
require less program memory, and will execule many Limes 
faster than the Applesoft POKEs! There are over two uorzen 
TOOLKIT BASIC and TOOLKIT DOS commands to add to you | 
programming repertoire. The syntax and function of these new 
comnands are covered in detail ‘in the next two chapters. 

- Before we get into the individual conm3inds, we will examine 
some of the technical mgratis of. the TOOLKIT system and TAKE 
r animation, 
& 
Wow ee 
K TAKE 1 TOOLKIT WORKS : re : 


tne TOOLKIT is made up. of thegh main coanonankes The TAKE 


| projector, the TOOLKIT one interpreter, and TAKE | ‘ 
TOOLKIT DOS: | Hots | 
, a Ps 


ig very. fast machine : language 
Vike running scenes, Grawing | 
anrounds , etc.’ This is disential ly 
eo Ps used ‘to run scenes. fi the TAKE 4 
Se. Zin the bank-switched area of RAM, |. 
Crs norma) eereltory 7 Usee mabe Ae: 


The projector isas 
routines. that do ,th 
Snapshots, decod : 
> the: ‘Sane projecty! 
-pr ogram, “It is 
out: bak ‘the “ of RASH 


hg 
of. 


the ‘ootktT BASIC. interebeter ts ‘the. interface. between - Ee go aa 
- hoplesort, BASIC and the projectors” vt also has some other 3. 
functions: that control’ .the hi-res. ‘screens,, “print hi-res she 
tent and: Ipad TAKE 1 files” into. your program, When your» 


ne ta 


ity Ih 


rahe ate as oe tbe ee ehat irate ries ee 4 


gtatement, 


other commands 


by the relocating’ code leaving somewhat 


mapas sere commands are suppor ted in the PROJG4 module. 


* bed 


t 


control is immediately passed to the TOOLKIT 
‘BASIC interpreter. There the TOOLKIT BASIC command is 
evaluated: and the appropriate routine is called. 


“TAKE ] TOOLKIT DOS is Stet lar to DOS3.3 with some important 
differences. It loads and saves files much faster and uses 
memoty more efficiently than standard DOS. The OOS a eetags 
and syntax are the same, however, you must load TAKE 


~ files using Lhe ampersand coamands (see Chapter 4). he 

“UNIT, CHAIN, INT, 

CUte function has been replaced by the HOVIEOISI formatter. The 
deal with Integer BASIC which is not supported 


and FP. commands are not. used. The INIT. 


by the TOOLKIT. The bulk of TAKE 1 TOOLKIT DOS resides in 
the bank-switched area of RAM (alonyside the projector) 


leaving more room in main memory for BASIC program files. 


of the system are loaded into memory 
when you boot up the TOOLKIT or a MOVIEDISK.. In fact, the 
TAKE ! TOOLKIT program disk is a MOVIEDISK! When you exit to 
DASIC from the TOOLKIT menu, the ampersand interpreter is 
already hooked wp and ready your BASIC program. No 
additional: modules need to be loaded or run. 


Al 1 three components 


Sesto vie 


RUHN | NG apa DOS3.3 


fio esity is to run the TAKE 1 TOOLKIT unger 0053.3 
{without using a MOVIEDISK) using the separate. projector 
modules available on the TOOLKIT program disk flowever, you 
will have less free RAM avatlable for BASIG. than you have 
with the MOVIEDISK system, These modo [es are completely 
relocatable and ‘can be rum anywhereiin op RAM above $600 
and below the 00S buffers. 

NL, .. 


Use the "“PROJ64" module for 64K and T2eK systems. The. . 
PROJ64 module must be on the same ‘dtsk as your BASIC program. 
To Install this module, use the oe statement as the 
first line of your program: we : 

; sey 
10 PRINT CHRY(4) “ORUN PROJGA, aiccareeae 


Recommended values for the address parameter are olupn if. 
Appendix A. | The PROJG64: module is approximately 7K bytes but’, 
the first 4K (the projector)’ ‘are moved up to bank-switched 
RAM when the module is first run. Anoth 1a 162 bytes are used 
ess than 3K (the | 
All of thr. TOOLKIT : 


ampersand interpreter) in main RAM, 


Ss ‘Use the "PROJ48" module for 48k systems. 

ae must be on the same disk as your BASIC program. To install 
~ e 8. this module, use the following statement as the First line~ 
*) Glee , 
my 

‘ Eo PS eg 2 Fe ee z sa es az 


The PROJ 4B module ie 


GR Grp ee eit coe ei SEGA Rg a oR LSA Pe bs 
sad SG ee ak RRR lap tt My a OS nd Be Bae ate ae: o - . . 
; fee ; age 


“of your program: . 
10 PRILT CHRS (4). “BRUN PROJAB, Agaddress” ak 


Recomnended values for the parece parameter» are given in 
Cort Os AppeR ie Aa Te PROJAB module is approximately 3.5K bytes. 
‘ fe) it includes the anpersand interpreter, the background 
decoder, and a mini-projector. This modules cannot be used | 
to run TAKE | scenes from BASIC but does support most of fhe 
other TOOLKIT Functions. 
é 
When these idles have been GRUN from your program, the 
TOOLKIT DASIC comnands will work the same as they do using : 
the HOVIFOISK system. You can then use the @HIREM comma! tos 
| set Applesoft HIMEM ee below the anpersand interpreter (see -. 
- Chapter as - 


iat : 


“WHAT 1S PAGE-FLIPPING? : | : 


There are two hi-res display pages on the Apple called 
(appropriately enough) Hi-res page |! and Hi-res page 2. 
Animation can be done using one or both pages. In single 
page animation, an image is drawn to the screen, erased, and 
then moved to a different location and drawn again, etc. . 
While this does produce animated movement, the erase cycles 
*are visible in each frame causing the image to Fiicker. One 
solution to this problem {s to eliminate the erase cycle by 
“using “block” shapes that have a black border. This works 
fine as long as the border is large enough to cover over the 
image from the previous frame. The border. works like an 
eraser, removing the last image as the nef: one is drawn on 
the screen. This Is the fastest way to-pnimate because no 
time ts wasted erasing the old tmage.. Stiowever, there are 
some limitations when using this tecfinique. If two or more : 
"block" images are drawn near each other, the last one drawn | 
Ree ee will erase whatever part of thetother image Is inside the ae | 
ae Wi | black border. When a block} Pimaye fs very large, you wlll 
| Cate be able to see ae [e) ao id image as _ the new one is being 


Jee 
tgp sh. SAR ie 
re SY eos é ing ay eS 


) drawn. CEO: eS 
e ne “att of the ete with “single page lentoak ioe can-be . « e4 
eliminated by using ‘both’ hi-res pages and a ‘technique called pe 


Es 


: : : “page-Flipping™ ec page- Flip. animation. you view one hi-res > 
Age ee fe * paye white erasing ‘and ‘drawing: to the opposite hi-res paye. 
OG ao ei vt a When you have finished drawing. a complete frame, you Ne 
et er eee ots Se sereens so that ‘you are “viewing the ‘last page drawn, and | 
meee OS drawing tothe last page. “viewed. Each’ time. you flip the. 
display pape, the. transition: from frame’ to. frame is crisp’ ‘an 
ys) smooth.” ate 


Be etanre gett bhi, There Is no Flicker. because you see only the. 
Bh em aS es CM Re, Rata eave Pea es 
Pa eager eee 9 completed frames and never. view. the Ad and beta ene & 
Ee es oct Nae ta eR AE ale 8 BM do sae pte SBS. 


‘ Or * 
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The TOOLKIT GASIC connainds allow you to do either he This {8 a program on the TOOLKIT disk called SPACE peKo”. he 
single-page or page- flip animation. To use the. “block” shape | : Lirte 10 loads the TAKE 1 background file "GK.SPACE STATION", 
technique. encoce your actors as Block Snopshots. If memory ae Line 20 unpacks the background and moves it to both hi-res 
is very tight. you may be limited to single-page animation. es display pages ahaaliea aes the restore page 3. Line 30 loads a 

When your BASIC progran is large. enough to write over hi-res. : Ee bes scene file named "SN,SPACE STATION" and also automatically 
page | (more than 25 disk sectors), you should do all of Soe 3 loads the actor files used in the scene. Line 40 displays 


your graphics on hi-res page 2 to avoid ch ha the program hi-res page | and sets the projector to start. drawing on 
and {ts variables. 8 hi-res page 2. Line 50 runs the entire scene using nage-f lip. 
eae ae sprite animotion. To sea this program in action, boot the 


Note that running a TAKE | scene from BASIC always uses a TAKE | TOOLKIT disk and exit to BASIC from the main menu, 


page-flip animation and requires the use of both hi-res | ne | 7 The type RUN SPACE DEHO. and | Press (RETURN). 
pages. | as ‘ : eae ; 
| oe et WANDS OH TOOLKIT BASIC 
TE ANIMATION ee ae , 
SPRI 7 7 . eet Now that you have seen how much shinkkion. can be produced 


with a 5 tine program, let’s experiment with few of the 
TAKE | TOOLKIT BASIC commands from the immediate mode. Type 
TEXT and (RETURN) to yet back to the text screen and then 
type A&SOUND B and press (RETURN). This is one of the TAKE 
i scene editor sounds. Try sSOUND 6 for an explosion. 


So far we have said nothing about the background. In, 
discussing the animation. options. In the above examples, 
the background was assumed to be black (at least where the 
animated objects are drawn). The “block” shape technique 
will erase everything In its path unless the border. ‘of the 
"block" is the sane color as the background. ° In-many cases 
you will want to move images ‘over a multi-colored’ background 
or each other without: leaving .a destructive path. This 
e-cechnique {ts called “sprite” animation. ; ey: fi 


Here are some other TOOLKIT BASIC comnands to try: 
R FRAME 65 BE es 
This will display frame number B5 in the scene that was 


loaded by the SPACE DEMO eeouran. Try the same command with |= fy 
other Frame numbers. 


A “sprite” is an object that can move on thescreen with 
multi-layered action that is independent of the background 
and other streen elements. Drawing a sprite on the screen is 


quite simple. Restoring the background when the sprite is: : | gee | s | 2 
moved to another location requires that the animation routine i & RUN 70 TO 118 Bia 2a | i 
remembers what thé screen looked Iike before it was drawn . oe, | ie , : i 
over. This is. accom) ished in TAKE by using a. third hi-res f This will run the scene from frame 70 to frame 118. 
page for the permanent background in the bank-switched areca . er | ee | : 
of RAM right above the projector. \This page is” called Bie Coke oe VAEM LD . hae: | 
s, “restore page 3". This paye is never viewed directly since. ' EE 
/ the Apple video hardware can. only display pages | and 2% : This will display hi-res. page. Ms - ae 4, | - 
Instead, Itt is used to erase “sprites from the hi-res pages a Ts oe AS aie shea ee i: ia 
by restoring the backgrotind.. ‘fo the. areas where the: sprites. | : me & CLEAR 1 : ene” ee an ok 
were drawn. at Se id 7 3 7 ; if py tet rey 
| ge QO . | This will. clear nines: ‘pagel. ‘to black. You should be 


looking at a blank ‘streod 


¢ 


While thie may - -sound PU Recngi idaseag it is Feally very 
simple using TOOLKIT BASIC-commands. To ‘pet van Idea how much 
« you can 69 with just a few lines of ae ‘take. a Took at 
a the following jie safe : oe 


‘ 
} “3 ° 
i ’ oa8 
‘ ee he 
, ‘ * a dha eer ee 
” $ 8 dea m per es 
5 iQ iad ols 
' tape " 


eae wit display the salxed text: Td praetor: mode. if the. 


cate sts ae 
10. & BK LOAD "SPACE STATION, Agcooo" : a ee CUrSUr sts not visTbleiat: ‘the bottom of ithe screen, hit 9 |) | 
20 & BACK 123 , OE es SET eT PRETURN] "2 few’ timesGunt | 1510 appears,” Now! ‘you can see the <p 
30-8 SN LOAD "SPACE STATION, $6000" a Be i Sa Mah 3) COMMANDS” you are t ping and watch: the resulls. on the hi-res fue 
«0 B VIEW 1: & PAGE 2. re eee screen a the (Same. Ripe seer 3 ec eee Pee 

id aie 
tere a a 
se ‘ Baise Ss SANDED MTP ERLE, yk sree Sate, Bee 
3 bakedidien’:-in Siku eee 


a $ PAGE 1 

Be “this sets the ‘drawing screen to hi-res page t. 

a oe & DRAW 1,1 AT 20,10 

a Tnts will draw snapshot #]) from actor {1 (loaded by the SPACE 
i Of MO program) at hi-res coordinates ths and y=10. Q 


ih Detailed descriptions of the TOOLKIT BASIC commands are 
ae given In the next two chapters. As you experiment with these: 
-cormands, you will begin to appreciate how much power the 
TAKE 1 TOOLKIT adds to your programs, 


i Wiha 


CHAIN, INT and FP. When you are loading TAKE 1 files, 


LOADING TAKE 1 FILES WITH THE TOOLKIT 


the specified file and then tel! the TOOLKIT where to fing 


+ ADSOLUTE ADORESS commands have the address parameter in 


are Segc | Fie exactly Vike O07: ar 


Se Via, oe 
% F Ae Sateen etl we x * 
1 BK Loan es a 
‘ , i ie ee Pe oust ‘ 

* ” we Byte ie eae 

rd ; hg a * oa 


TOOLKIT DOS COHHANUS 


Disk access from the TAKE | TOOLKIT is similar to Applesoft | 
running under 0053.3. The syntax is identical to 00S3.3 with 8 
all of the standard DOS commands available except INIT,. ee 


however, you must use the TOOLKIT 00S ampersand commands. 


o- 


(The TOOLKIT has its own “smart” 00S commands for loading 
Actors, Backgrounds, Scenes, and Character Sets. These 
comnands are called from BASIC using the ampersand (4) 
instead of the usual. PRINT CHR$(4) syntax required by normal 
DOS commands. . The TOOLKIT. DOS ampersand commands will toad 


b Rae be i ™ ty x é E ei 
se ceiinapaameeatiteaiamtitiaditiiaadaesiinatitteadiaian teeta oe Te 


the file when it is needed, There are two types of TOOLKIT. 
DOS comnands : | 


the load statement. The File will be loaded at the address 
specified just like the normal DOS BLOAD command. 


* 
a 


a CHAIN LOAD comnands’ do het have an address parameter. 
Instead, a semicolon ts placed at the end of the load 
statement. The file is then. loaded right behind the last 


loaded File. 


9: 


te “i 
Thexadvantage of this” system i 5, ptait it allows very "ear. 
effictent memory management. ent tedious calculations. 
The programmer can, $ wae pi area of memory for TAKE | 
files and use the hag Oe ADDRESS conmand to load the First . | 
file and ther{ Ch sem the remaining files with no wasteg 


spece. 


The syntax of TOOLKIT DOS cuneate is similar to normal 
DOS3.3 with some important differences. — The “filename” in 
these comnands Joes not contain the AC., CS., BK., or SN. 
prefix. The prefix is added automatically by the command, 
This..is consistent with the way files are loaded in the TAKE veh ae 
| program. The address, drive, slot, and volume Parameters: ia 


Mere Is ‘a een | of the TOOLKIT ‘00S: ‘commands 


ea 
: * 


“Leads” a “Tae 1 background rites 


M : Sith Myla Ag wg eae er > re RE Meee Sg ty Su Ae ol tee oF 
OF as BEE ETS eb er Se eo ea tea Pagghton iether at 
i: * . 


h ‘3 at 


can be used i the TOOLKIT ¢ at.a time. Note that this conmand 


does not decoue. the compressed background to the hi-res 
screen. This is done using the &BACK command. /Po not load a 
background file directly. into the same memory. area ieee to. 


display the decoded pletire, 


* 


es ate . 


TormaW. 
: & or LOAD “Filename, Agaddress” 


This is the. ADS SOLUTE: ADDRESS format which. ye ihe 
background at the specified ‘address. 


Format: 
& BK LOAD “Filename”; 


This. formot will CHAIN LOAD tne background to the end of 
the fast loaded TAKE 1 file. IF memory.is tight it is best 
to load the background with the ABSOLUTE format and decode it 
-to the hi-res screen using the &BACK command before toading 
any other files. Once it is decoded, the background file is 
no longer needed. and can be safely overwritten when you load 


the next File. 


“§ CS LOAD 


Load a TAKE | character set. Only one character set may be 
active-at atime. This command will delete an existing 
character set. — : Pee ey : 
Format# 

-—— 2 & CS LOAD. "Filename, Agaddress” 


Load the character, set file at the address specifigda: 


Format: — ; ee ae. Ae cae" 
m 8 cs LOAD C i A 

Load the charocter set fe 
file. 4 em 


* % 


the yend a the last loaded TAKE ] 


os 


& AC LOAD 


Loads a TAKE | ctor File. Up to Kai geAbrs can be used at 


one time. After the first actor is waded, sadditional actor 
files MUST be Icaded using the CHAIN LOAD Format . 


Focmat! : ¥ oe 
& AC LOAD “filename, Agaddress" 


This will load ihe ector File at the address specified. 


 s 
o 


Sun eet ot 2 ren Tek 
est ee ME Ty 2 eee Tae ed aa ag? OP RR ee horaage A RAG gk bi, : be aa ctl 
t * : y - 
‘ 


‘where var ts an Applesoft veal War lablact When this command: 
oy As used, it will set: var: equal: ‘to: the: end of the last gee 
i “= loaded. TAKE 1 File. plus. Peet ‘scUseful if, you have chain’: ie 
apeleess all of. the TAKE. af: files, for: Maa Preece: and want! to. 


Pret 638 tors « * ey Ske he team sete | om 118 pe ee vee ¢ tat: » . 3 5 rar,” hy tine ow sis, 
% eat 


hay time an actor tS, loaded. using. the ‘ABSOLUTE ‘ADDRESS — 
format, all pr avi eus ty Seeded actors will be deleted from 
the Braga. . 7 


ad 


y AC Loa. Fi Vename™t 


Formats 


Load the actor. ‘at the: ig ‘oF the face’ ceded: TAKE 1 file. 
This formot MUST be used. to toad additional actor files to 


the program. ae 


& SN LOAD 


This comnand first loads a TAKE 1 scene file and then 
automatically chain loads any actor and character set files 
required by the scene. Only one scene can be used by the 
TOOLKIT at one time. IF the scene uses actors, any actors 
already in memory will be deleted. tf the scehe uses a pre 
character set, the character set already in menory wil! be li 
deleted. me 


Not available in the PROJ4D modyle. 
Format: aed ee 
& i LOAD "Filename, A$address” 


Load the scene files starting at the address specified. 
This is the recommended format to use when loading scenes 
since any existing AC and CS files will likely be deleted 
anyway. | 


Format: 
& SN- LOAD "Filename" ‘e 


Load the scene files at the spce eas. th the! Hast loaded TAKE | 
file. ; This ‘format is o weedhin nended for Joading scenes 
although Ante a rapide ases where Ht ib useful, 


a next a3 : , ia ough 
Nef ee? ae ‘ ei / 
This comnand returns the address of the next available 
yeeeasd 4 hadeack for a chain load. er 
Formats : a oe rae : se 


& NEXT LOAD var, # 
; ot 


» 


u 


Note that the “BK. 


‘memory to load all the actors 


actor load in line 50. Note” th 


.. yvartables have Gecimal, 


3p PRE ATTY EYAI LES 


a The following is a typical sequence used, to toad TAKE | 
* ak files in your own program: 
<e 10 & BK LOAD "PICTURE, “A46000" 
a 20 & BACK |. 
ee 20 & CS LOAD “BOLD 10, A$é000" 
40 8 AC LOAD “ACTORI"; 
50 § AC.LOAD "ACTOR2"; - 


60 & AC LOAD "ACTORI"; 


Line 10 will load the background file named “OK.PICTURE” at 
memory location $6000 (24576), right above hi-res page 2. 

" prefix isnot used in the comnand 

Line 20 decodes the compressed background to 

Since the background file is already decoded, 
we can load the remaining Files'right over it. Line 30 
brings in the character set "CS.BOLD 10” at $6000. Line 40 
chain loads the first actor file "AC.ACTORI” to the end of 
the character set. 


filename. 
hi-res page I. 


actor files. 


Now, suppose you want to use seve rod i feceaks actors in 
different parts of the program ag Oe is not enough free 
io time. By adding just a 
“87 load several different sets 


couple of lines of code, yoe 
the character set: 


of actors without writing, Ser 


ck ie A$Go00" 


10 8 

20 A 

70 6 Clete 10, A$6000" 
40 oe 

50 8 oad” “ACTORI, ANZ 

69 8 i LOAD “ACTOR2"; 

70 & AC LOAD "ACTOR": 


Here Line 40 gets the next available load address stier the 
character set into the Applesoft variable Z. This variable 
is used as the address par 


for the DOS address parameter. This is because. Applesoft 
not hex, values. 
files are chain losded as usual. As jong as yor have not 


“earelessly redefined the variable zy 


2010 & AC LOAD. ACTORS, ANZ 
2020°& AC LOAD “ACTORS”; — 


Lines 50 and 60 chain load two additional: 


gine ter for the “ABSOLUTE ADORESS 4 
rat "A" is used instead of Nat Fee 


“The ri emaining: actor 


you can use it later) ee che 
Bi the program to Joad the next ‘Sete of actor- Files: | : ae 


ee) : ere 


eS py ee 
: - s 


In Vine 2010. \ACTOR is loaded right on top of ‘ACTORI at __ 
address Z. Because this is an ADSOLUTE ADDRESS load, the : 


previous actors will be deleted from the program. The 
character set is still intact because it resides below 
address Z and has not been Sones over. | 


ADDITIONAL DOS COMMANDS 


In addition to the standard 00S commands and the TOOLKIT 
00S comnands, . there are two new DOS commands available when 
running a MOVIEDISK: 


* 


MAXFILES 0 


The MAXFILES comnand allows you to specify the maximum 
number -of files which may be open at one time. When you boot 
up the TAKE 1 TOOLKIT program disk or a MOVIEDISK, there are 
two buffers available for text files. If you are NOT going 
tc use text Files in your program, -you can gain an 
additional 4 of RAM by using the special MAXFILES 0 command 
(see Appendix A). This comnand deletes al! of the buffers 
and code used by sequential and random-access text files from 
memory. To set MAXFILES 0 in your program, use the 
following statement at the cnet oOtyour program: 


; , a 
ce 10 PRINT chinggg®haxr LES 0” 


The MAXFILES 0 gio *does not affect the following DOS 
conrnands: NW, BSAVE, CATALOG, DELETE, LOAD, LOCK, 
HON, NOHO? » RUN, SAVE, and UNLOCK. Once the MAXFILES 
0 command) Ghog, used, all subsequent: 00S commands that 
operale on ‘iles (OPEN, EXEC. READ, MAXFILES. etc.) 
will result in a MAXFILES 0 error message. The system must 
be rebooted to regain the text file commands. It is 
recommended that you use the MAXFILES 0 option only when you 
require the extra memory. 


FLIST 


You can print the data From: a ak File. directly to the. 


screen. (or other output device) using the tie command. To 
use re command in the. inmediate mode, ityper , 


* 


‘ is Sein SY, : oo oR AT aa ih 
r ¢ nam Sy a aes 
a om " "g le ec Dil ae in eee oa H 
‘ on i we es Me ae 4 
Se . vataloes Gr ‘ee a Ps é 


Use. the folioning syntax, to ‘access “the: rust. commands from 
[your atthe Progr ay 7 Spal 


wh ae 7 “ ee : 


he, 


10 PRINT reat) crust ‘titeet 


* 
: 
} 
ati 


a ie 


Saat 


In front of the command stetement. 


commands if they are connected by a semi-colon. 


TAKE | pow ote CONKANDS 


This chapter describes the Santas for TAKE ] TOOLKIT BASIC 
comancs. The conmands are listed in alphabetical order. | 
Lb TAKE 1 TOOLKIT DOS commands are described as eeerter $0) 


All of the TAKE | TOOLKIT ‘codnands reduive an Lecce canes (h) 
A single ampersand 
statement can contain several consecutive TAKE } TOOLKIT 

For vara ae 


10 & PAGEL: & CLEAR 1: & VJEW! 


10 & PAGEI; CLEAR 13 VIEW! 
t4 
Both lines are val td syntax for TOOLKIT naa, The: 
advantage of connecting TOOLKIT commands this way is that it 
uses less memory and the comnands execute faster because thry 
do not ‘go back to Applesoft for the next. statement. This 
syntax CANNOT be used with the TAKE } TOOLKIT DOS commands or 
the & SOUND FN Saieeate 


‘ few of the TAKE | TOOLKIT commands use Applesoft keywords 
in.the conmand statement. While it is possible to misread a 
TOOLKIT statement for an Applesoft state nené%and 
vice-versa), there are some definis Cantages for using 
this syntax. Applesoft keywor gic 08t less menpry (one byte 
per word) than n qsytb e byte per letter). The 
keywords also u RiT's fory in the anpersand interpreter 
and execute sl ster. Wherever possible, the TOOLKIT 
command is simi unction to the original Anpplesoft 
keyword (as in &0RAW or BHIMEM), or uses keywords that 


‘rarely appear in Auplesel’ programs (as in BNEW or &RUN). 


TAKE 1 TOOLKIT SYNTAX CONVENTIONS 


The following conventions are used in def ining the syntax 


formak. pf the. TAKE ‘VTOOLKIT comes | ; bet 
"UPPER CASE : Upper-case words and letters mast appear 
4 Sie a enacklyiay, shown , An the. aeaterent format. - 


“lowercase: Generic: ‘terms (expressions ‘and Var tables) 
are. lower. case {n the statement formet. 


bak Bei: a ee ‘The programner oupels tes. oh exact | number 
oP ee OS Te COP |exprasn lon. ai A SRV tp TEKS 


aed hs 
Bed Ps pe pat 2 5 ‘ rah % 
a4 y i ‘ yy f : eas j ii ei oy ee Pos ¢ AS, Beh 4 i thee 
¥ f vey 4g : 
‘ + 3 


ra . cs ‘ 8 
wal Gee 7 * get f : . WH og cs 
‘ i ¢ < & 2 4 > eee 2k" 


i 
: 


se 
ae 
oe 
bees a 
de ts 


o 3a8 
ee 


ies 


> Side iw © 
ferns eit ay, ae tan WLIES es hie F 
Hh gal sire Np hes a Sick aes Bee SONS oe Sie 


punctuat for. UAL commas and semicolons-must appear 
of as shown, See eee eae 


Eilipses indicate that the apacacding. item 
can be. repeated; ellipses do HOT appear 
in the, actual pregr es statement. 


Ing generic t terms: are used In the command 

ny BASIC program. Vine nunber. 

“An Applesoft Rumer 1c real var fable. 

A numer Ic constant. var table, or expression. 


A string constant, variable, or expression. 


Numeric censtant, variable, or expression 
that evaluates to a horizontal screen 
coordinate. : 


Numeric constanty variable » or expression 
that evaluates to ) vertical screen f 
coordinate. ced 


‘ re 


P 


“oonmang, STATENENTS,S 
Commands marked with en ‘ are notval lable on the PROUSH 
module. In general, any’ commas” that is related to running | 
a TAKE | scene is not suppor ted, in the PROJAG module, ey & 


a ba ee ae oa ae 
Je 
Checks to see a key has been pressed and returns: the: 
ASCII value of the keypress: to the BASIC program. 


ey mw. : 
Format oe Soi mee 
, Ayeg®: ae vor c is 


~~ i ’ 
ie i y ay ‘ a 


When a key has Seen ‘oreberd, “the asclt Walue of the: 
_keypress is returned in var. JF no key has bee’ pressed, 
var will have a value of zero. Fae 


& DAK 


as AS ey 


—Decodes the ‘beckground: File in mensey to one of the. hi-res. 
‘pages. an no. PDeenOr ou has been loognes. or the background 


i RIN SE A a tm: see ee ee re ae takes, 5 nee 
; Bess . 


SR SR ha a Lean + Fee een “ 
mG eas Oey Ct a (try totes CP oe) ak See 
J : : ¢ Si 


fee opel wr cneipcinreon paitenser GA” Lead 
Cr er aren” AY Ore sree ee te H 
Ue Sakae TERA S x She? Gare 


oH 
rote § 


eRe Bes. oh. hee i ays, “praia ied lee Bae At, 7 
eer ea PRE SAINT Bee AE ETA eR Re aA SRR 


: ; “ ‘ evi ‘ 3 Me ? 
| SG oo Scan Recta tae ie aa ea 3) 
file ‘has /been written, over, by another File. van ouT ‘OF MERORY 
error BERME Bx: FS on SUCHE a Sh ep ee Rn “ ah W be tha 


Formats 
aug b BACK ° 


* 


‘Decodes to the. current “drawing page. 


Format Be pe. ae a 
& BACKI23 oe i 
Decordes the background. to both hi-res display pages end 
also the restore page 3. This Is the standard way to decode 
a background before cunning a scenc. This also prepares the af 
hi-res screens for page-flip sprite animation from Basic. ae 
& CLEAR 
erases the hi-res page. ‘bo black. This command does not 
ALTERS the status of the current Prawing page. 
Gs z 
: harman : , er 
oF LI CLEAR ot oo 
. | GY. . 
| | Oe te 
ars ine i Urawing paye. | 
ore. are gees 
oe} A CLEAR exprn ace ; 
ee fe ; 
_ Erases the hi-res page defined by exprn, The exprn can a 
be 1, 2. or 3. ree | AB cles ) eRe 
Formetle ee eae see Da eee : 
ee A CLEAR Aad © be . a 
: ‘proses: oa hi-ter ‘display. eg, ‘and nie the bietate pane me 
f re This is the. standard, way to. ‘set: up a ‘black, background ese 


before ‘running. a scene, “This: ‘also. prepares: the screens for 
Bee ee sprite an ination fom BNSIEK : : 


ise 


eile ew 
car ea 


ras i ipooeets so re ie ? _ 
ae es mak stereo et Se a 
ine te le ke gg ining SA ag Sai EO ‘. =" 


My, Y 
. a 
iS, : 
Ps i" 
* 
- “4 
® ‘ : + 
‘ F ‘ +4 
« ”~ . ‘ 
4 ? ' 
? 
*: % oa Pi 
if : s 
¢ k Ma 
‘ ? rp * wed un 
FAS A Se MEE ES 1s ade cal i 1 Reece ee we ea ee ¥ i 
Pacman ee Ne a la sats vino “hii rig Seana I eset tN RM 


' Formatt 


- 1 wlll copy hi-res page 


g COPY 


Copies” one e hi-res page to another. 


pk ¢ COPY exprni ae exprn2 | 


 Coples . hi-res page defined, by “exprnl to the hi-res page 


def Ined by” exprn2.. For example, the statement & COPY 2 TO 
2 to hi-res page i. This command is 


very fasti - 


ee 


& DRAW 


Draws a snapshot From an actor file to the current drawing 


page. 


Formats : 
& DRAW snapshot, actor AT x.y 


R ORAW snapshot AT Xyy 


res screen coordinates. In the NORKAL 

the snapshots can move off the 

x may have @ylues from ~2B0 to 

+280 and y can have values from pan eo +192. In the WRAP 

drawing -mode, _* ‘abe of x Is 279 and the range of 
is 0 to 191. ae et valueggits id this range or - , 

attempt to draw aise yt that ¢f GO not in memory, . afi ILLEGAL 


QUANTITY ERROR will result. a ar ee 
The actor parancter is sepa If mo actor is sppcified, 
om the dast actor file accessed. 


the snapshot will be take Ue 
a vets Is related to the order the 


The value. of the act 9 
actors are loaded pala “tre disk. The first actor loaded 


becomes actor Hl. thé seconds actor loatiact becomes: actor H2. 


and so On, 

if a drawing. 
comnand, only the part o 
will appear on the screen. 
the window will be: el iged. 


where x and y are hi- 
(no-wrap) drawing mode, . 
screen In any direction so 


“window? ic been set wth the AMINOOK 
f the snapshot Inside the window 
Any part of the snapshot outside. 


4 FLIP 


Displays the buerent drawing page eis then sets the drawing 
page to the bie ene hi-res Paes 


Renee ewe kaw es 
* 


nyt <emees s * 


‘e. 


« 
Cee” ‘ 


a 


» +o ee 
9 he Aad 0 . , 
righ 4 eda anal nt Am 8 gente pte 80: 


Format oe ae ie er) ge 


ae “your BASIC proyram,. “apreventing string aul wee from writing 


van fe * 


| S ‘FLIP. ee ede WERE 

| ee a a 

! “Ain oe-biio snimation: you view: one hi-res page while a 
aang to the other. When you have finished drawing a | 
“complete frame. you “Flip” screens so that you are viewing | 
othe page last drawn and drawing to the paye fast viewed. — 

: : - | 


h FRAME ey 
e froma TAKE | scene file in memory. 


Displays” a single fram 
Jed an OUT OF MEMORY error occurs. 


lf mo scene has been loa 


Format: | 
, _& FRAME exprn e 


_1s the frame number desired. If you set exprn 
to a value greater than the number of frames in the scence, 

an ILLEGAL QUANTITY ERROR eccurs. This comnond dots a paye 
flip after drawing the frame to the screen. 


The expra 


R FULL 
This is the some as 


. Selects the full-screen graphics mode. 
tie, 8 


POKL-16302,0 from Applesoft BASIC. 


Format: 
A FULL 3 we. 
“Lf the screen js in the; sfext mode, this will not be 
‘visible until the &VIEW Ph icsaris turns on the hi-res screen. 
If you are, runni attscene or doing page-flip animation from 
. BASIC, the. ful sereen mace. 


4 


mo epee : : 
tie eats " 
0 PA eS ot ingen Aegan tN tS AC LIE EL ALLL LILI LLEAL LL A eet tt, 
eee an 


os 


A HINEH 


Sets nteiert HIMEM to dot below the DOS buffers. ‘Sets ff 
HIHEH to just below beet TOOLKIT interpreter in the PROJ4B ond t 


PROVES modules. 


e 
,. 

oie Me 
ae 

ie 


7 cn 


x ig : x 4) Se as 


“This establishes” ‘an. ‘upner. “Limit on RAM that is aailne to. 


‘over. the. FOOL Anterpreter.. De, ae are taea ile = 


% et a % 
a +e Big 5 Pe ae EG . ‘ P i 
. eae ; the 
i > : i a A 


3 haa 
AR ialae ee 
“$" Ave, ee he 


43 x 4 és webs “ 
iis a et A "tats a 
Poteae on Peet ae ; 
Sige eae Lgl A gay 
+ ” , + * f ef 
» - ¥ Fie 
hal sie Hy or* > 5 “a's ‘ee 5 


th ee Pe eters anatase raked . 1a 
; Py. oh | sack st oe ert ge eigen 8 sich taste igs iM th wee ne Pon , 
ae are Pe koe ete Ae i. oh legen Sahn aay nn soa 


oe 
fe “cg 
3 
re 
i 


ip eS AE he 


* 


the same as. 


t KIX 


Selects the mixed Seah and graphics Bianiey mode. This is 


POKE-16301.0 fron Applesoft BASIC, 


format: 


$ 
« 


«} 
Ae 


RB MIX 


UF the screen its. in the text mode, this will not be 
sible until the &VIEW comnand turns on the hi-res screen, 
Do not use the mixed text and graphics’ mode with page Flip 
animation or any graphics display on hi-res paye 2 as the 


. text window will show garbage in this mode. 


* 


ey, HE W 


Formats | . ee PP as gee 


of the selected keys. was “pressed, 
2: GOTO a selected prograt “Vine. 
i warpath lon on “theyhpalesoft ON-GOTO” comnand. 


Initialize the TAKE | TOOLKIT interpreter by deleting all 
active TAKE | files and setting the default seit page to 


page |. 


Format: 4 
& NEW 


This conmand does NOT affect your basic program tn any way. 


& NORMAL | 


“—- 


Sets the &0RAW comphds::to_ Fick lon In the prep mode 
wereen. 


using the entire hi-res. 


ie NORMAL, 


This “comnand cancels the: effects of the BYU NOM and LwZAP 


Ps 


BON ASC - GOTO. * 


4 


Checks to see if selected. hovel have been suagncd: IF one 
‘the program will GOSUB or 


This fs a@ very powerful 


s { ae to. 


£ OK ASC! exprl,expr2 «-. - cosuB oe line2 - : 


a oN ‘ASC exprl, expr? ae GOTO linet, line? ere, 


Gee ee The expri, expr2... es are ASCII values | of the keys you | 
. want ¢o process. The Vinel, lites ss are BASIC program 
fine numbers. The program branches to the first tine umber 
if the the key pressed matches expr}, to line2 if the : 
keypress matches expr2,. etc. If the keypress dees not match) 
any of the exprn values, or no key was pressed, program — 
execution continues with the next statement. 
: This comnand is one of the most useful of the TOOLKIT 
! coninands. It provides 2 one-line keyboard interpreter 
! | replacing several tF-THEN Jines in your BASIC, progran. For 
exaigte, if you want lo process the 1, ds K. and NH keys, 
you use the following statement: 
| 10 .4°ON ASC 73. 24. 73; 7 GOTO 100, 200, 300, 400 . 
‘This single statement is replaces the following lines of 
Applesoft BASIC: | 
ree ; 10 KO = PEEK (-16384) : POKE ~16368,0 
ae 2 Fo a AG WB ew 19 TER COTO 400. 
Sn eet 30 IF KO = 74 THEN GOTO 200 
40 JF Ki = 75 THEN GOTO 300 


50 IF KB = 77 THEN GOTO 400 
& PAGE 
Specify the hi-res page for drawing. This fis not 


- necessarily the same as the page being displayed. 


* 
0 
= 
ans 


Formstt. : | te gh 
st, & PAGE exprn. 
ae ; of | 
The exprn speci Fiessthe. Wleees page for subsequent 
drawing {mast be pagel or. 2) ‘This affects activity of the | 
Following ere SP ADRAW, TEXT, BCLEAR, BOACK, | 
 BRESTORE: PANT he 
Af-you’ nue ren running, a ‘scene or doing page-flip 
ms gatindt fon: “From ASIC,” and want to know what the current 
raving. page ae use the following format: 


oo F 


e PAGE VAL var 


e 


Sis tulement will fetuen the current. drawing page’ (either 


“or :2): xo. the numeric variable var, 1 f, 
® si > we es 
: ea oe ee cae 5 a! 
i oa i‘ Ag i 
oi As et 
PRES eae : 
a ¢ rf Thy . 5 
2 alee toe 
swe ene ao 
a: ae i 
& 
a fetes ° ws iid * i : 
. See AAT Saat ee aye ree ig i amnees Stay 


Paes Jou bee Satanic So diac clei wailing Saipan: WAN finite Pena ase 5 ook Aca re ae i sg MRT UMS Te . : th | ing sie 
; aa : : Bee Format: we ee ; a 
Copies the current drawing page to the opposite hi-res page , ; : “& RUN TO exprn ee 
AND to the restore page 3. : es en ee a 
ne Run the scene From the beginning and stopping at Frame | 
Format: ey : | ; exprn. ee : . 
& PLANT : ees , 
This ts similar to the copy command. It automatically | : _ & SOUND 
makes whatever is on the current drawing page a permanent ene : ‘ 
part of the bahar ours for page-flip animation. | oe Play one of the standard TAKE | sounds. a 
oe o 
. ; : Ce ae = | Awe Format: ee ea 
& RESTORE ; ate baat : , &8 SOUND exprn : ance 
Erases all snapshots from the current drawing page by | | The exprn is a nunber From 0 to 17 and is related to the © 
restoring the background from page 3. This is extremely fast ? . - sound effect numbers: in the TAKE ! Scene Editor: We 
since it only restores areas of one screen nee snapshots ss 3 : H ae 
have been drawn. ' 4 ; a 0 Click .- 5 Crash — 3 g 7 ie ae 
| ae ee Lie es 1 Pop 6 Explosion ee 
Format: ) | Ee , | ie 2 : 2 Footstep 7 Ray Gun Cae 
& RESTORE — : , ae ee. ee 3 Beep 8 Slide Up ? 
: a : Be 4 Double Beep 9 Slide Down : 
When you are doing page-flip sprite animation from BASIC, : : i ; | ee 
this command will prepare the hi-res grreen for drawing the , In addition, the numbers 10 to 17 will produce a one | 
next frame by erasing all snapshoty, FF om the previous frame. octave musical scale. ; | 
Use & FLIP; RESTORE for r pagectyoptng | with. ill dete a : pa | 3 
Pe oo SOUND FR 
& RUN : . gi kat Deas , ae 
Pee See ep ae / The sound function command allows the programmer to define —: 
Run @ TAKE J. 5 Ant fe that is Im memory. If no scene has ey -« @ custom sound:effect fron BASIC by specifying a sequence of sf 
been loaded an*OUTOF MEMORY error occurs. — ag : duration and pitch values for the gerd 
Formats Vig eo | | : To Pan Wer: 3 Formats — : eet eD a 
Pe RUN 2 oe : ee | a SOUND FN dur piteh@. , Le ; 
ea a Cae fae eee : ae . 26 ee ee 
Runs the entire scene from beginning to end. ro ee - The dur is the ‘duratioa. parameter, and can, have values Jee 
alee 7 | | | - me i ee fron | (a few milliseconds) to,755 (up to a couple:of ‘seconds of 
Formats ome : eee Les a Pe : depending on the pitches The pitch ‘is the pitch or, ae 
: v8 ‘4 ye exprn a: ae | Le ie nae - -< frequency parameter. and, can ‘have values of 1 (the highest: .« 
: ee eee ee eh) te 254 (th wis? piteh) A pitch value of zero will 
Runs the scene starting: at the ‘frame defined by exprn tO 9 Fe | vide PE ORUER no sound Wot $ very useful as a pause. A pitch 2 
vhs ence co Oe (<value of 255 proflucy a random nuise that ts useful for 
| wes cy ene peel bbe ts : Me Be are prion and agivate girregu) st: Bours. oe 
| & RUN ele TO exprn2 wee ae ag ag Age 8 Od PEATEs SS 
| i Uae of SOUND FW dur pltent ee 
Run the scene starting at frame exprPnt — on. stopping at Joa seh eee ey a ae | s wee at 
irene See : a ee Paes loca gt 2 eevecal” Hour spleens ‘paieS: can’ be connected’ in the . same 47°28 
ae a8 og Mess » SOUND FN ‘statement, ‘This provides ‘the capability” for. an 
: ees paiie Hiptinite: variety of: Sound effects from BASIC?’ ‘Because. “the | 
: 4 Se a ; ig ee ol ‘ ve FN yeaa uses the: semi-colon to connect, :dur sPLSEN we 


So pairs, this command CANNOT be combined with other TOOLKIT 

mi - commands In the sane ampersand statement. The tast 

*dur.pitch pair MUST be followed by a colon (end of 
statement) or be at the end of a program line. 

z The TAKE | TOOLKIT program disk has an Applesoft program 

ye called "SOUND FN GERERATOR” which allows the programmer to 


HS hina ce with &SOUNO FN parameters to create Bg On 
ee sounds. : c 


te 
m8 TEXT 


Prints a line of bent to. the current hickes drawing screen 
using the character set In memory. If mo character set has 
been loaded, an OUT ad HEHORY error wil) occur. 


ae 
Wink re) 2 
e ee : 


Formats 
e. & TEXT xyrexprd ; a, 


ae The erpr$ ts any: Applesoft ste ing@Npression. The x 
- and y are hi-res sereen iat and can have values of 
0 to 279 and 0 to 191 respect Text ts always XORAWN to 
the screen Ina full sche eb ie mode and {ts not 
_ affected by the AWiNnoit pie ‘comnands. 


7 «An easy-way to erase at) of text that has been printed 
fet a* to the screen is to. use. the EXT command again at exactly 
the same x.y coordinates. 


a 


ec ae x4 
TN oe +, ee 


Displays the hi-res graphics screen. This ts similar to 

POKE-16297,0 : POKE-16304,0 from BASIC.. The yraphics mode 
displayed may be full-screen graphics or mixed graphics and 
Be text depending on previous use of &FULL or AMIX. The &VIEW 
“command does not affect the status of the current Bra aaa 


- page. This is set by &PAGE or aie 


-* Formats ~s 
“ ~~ & VIEW 


> 


Displays the current drawing page. 


<<. Formats ck 
oO & VICW exprn — 


fess. Displays the hi-res page defined by exprn, 8 VIEW } tL 
“ee display hi-res page land & VIEW 2 wi ae hi-res page 
S = | : eae at 
pou . 4 : Ee Mu 
ae i. 
ee 
tygle oe o Stl once ST ate pt om ae ~ * - oo + ~emege ‘ 


ee ee ee 
% fe 


wm, 


values From 0 (the top edge. 


to 39 (the ri 


bytes, divide the horizontal coordinate by 7. 


-&WINDOW 0,191,0,39 but takes less time and space in your 
- program. 


ty oR Oy 
Pe ee ha, Maha tae 3P 


h WAIT a 
Will delay program execution for a specified time period. a 
He | | a 
Formats: | : 
& WAIT exprn | 
._ The vaiue of expr determines the length of the pause in 
1710 second time intervals. The statement AWAIT 15) will i 
generate a pause of 1.5 séconds. 5 
| Ii 
A WINDOY | 
| es | 
“Defines a drawing "window" in the hi-res screen. When this at 
, comnand is used, ony subsequent &£DRAW comrands will draw 3 | 
oo oenly the portion of the. snapshot that is inside the drawing : 
‘window. Any part of the snapshot that is outside the wincow Ae | 
will be clipped. This comnand automilically sets the nowrap are | 
‘drawing mode and cancels the effect of the BWRAP and &HORMAL pe | 
comnands. aa 
eee aa 
Format: ! 
; “& WINDOW top, ast right ) 


The bab ler bottor . int a are line numbers with 
ve screen) to 191 (the bottom 
exif Se the top and bottom screen 
left and right parameters are 
7 es from 0 (the left edge of the screen) 
Rte eyof the screen). -A screen byte is 7 
avert horizontal coordinates to screen 
if the top, 
bottom, left, and right parameters are not valid screen 
values, an ILLEGAL QUANTITY ERROR occurs. i 
To reset the drawing window back to the entire hi-res 
screen, use, the &NORMAL command: This is the same as using 


edge of the screen). 
lines for the w 
screen bytes 


dots. ‘wide. To 


Setting the hi-res drawing window hs no effect on the 
BTEXT command, 


Sets subsequent bURAX ccoamands to function tn sereen 2 ie oe 


wreo-around mode. Normally a snapshot is In a no-wrap mode ! : ee : 
and can be moved off the screen edge. In the WRAP mode, a The TAKE |! TOOLKIT disk contains several BASIC programs 
7 snapshot that goes beyond one edge of the screen will that illustrate how the TOOLKIT BASIC commands are used. The 
“Y  peagppear at the opposite edge of the screen. | First four sample programs show the various types of 
od animation described in Chapter 3. These include single-page | 


Pie 4p WmRAP Oe 3 | oe oe Beas 2 Pa 
2 ay ee PROGRAM EXAKPLES 
= Oe ep i 


ae Format: | ai es ie and page-Flip animation using both “block” and “sprite” actor 

i & WRAP | 7 files. In each program, the "sprite" actor moves across the 

ee a eee top of the screen and the "block" actor moves across the : me 

EA This cocmand cancels the effect ofthe AWINDGW command. | center. Boot up the TAKE 1 TOOLKIT disk and exit to BASIC.” ee 

fe The wrap-around drew mode always Uses the entire hi-res then run each program while reading the text. 

8 sereen, . ye ae . | Bae Sy | : ue 
oe | — s | | fog, PAGE FLIP ANITHATION tii 
a This program uses page-flip animation (both hi-res screens) | le 
ce with restored background. This is the best technique for Aa | 
a moving objects over a multi-colored background with no se! 
a flicker. 3 ee 

te 3 . 4 

S Pe i. 3 "10 8 NEW; HIMEH ae 
3 | | | 20 & BK LOAD “CUBES, A$6000" ha 


- ae | 30 & BACKI23 i cc 
; pe ” oe 40 & AC LOAD "BLOCK CUBES, A$6000" 7 lids 
ie : : oS ; 50 & AC LOAD "SPRITE CUBES": 7 
‘b 7 or : 60 & NORMAL; FULL; VIEWI:; PAGE2 
we Ce Ea Se ae 
% ng ae ea 100 FOR X = -40 TO 260 STEP 4 
as eo 3 os ae 10S 25 ¢ 1: IF Ss Il THEN S = | 
120 & ORAW S,2 AT X,10 : 
: 130 & DRAW S,1 AT X,90 
pee a4 Ds eee | : : 140 & FLIP; RESTORE 
ae s | gp hg Ba : 150 NEXT 
pt Soe f , 160 GOTO 100 
ae Ny a es fs | f i : Line 10 initializes the projector clearing any actor files ha 
oo a op be that may be left from a previous program. Lines 20-30 load OTs 
ees ist on ; : and decode the background to both hi-res pagés and also to Mo 
- | the restore page 3. Line 40 loads they first actor file using 
Got es | a ts 3 | Lad the ABSOLUTE ADDRESS conmand. Sige®'the background file has 
| ek ; eae ~ already been decoded, the a gk file can be loaded right 
. | : 3 | cver it. Line 50 {dads héessecond actor file using the CHAIN Bae 
ee LOAD camnand (a ba olpn after the filename). Line 60 sets 9 (8. 


% a up the display screen and drawing screen. Note that four : 


: : 0 IE ee TOOLKIT BASIC commands “are called with one. ampersand 
Tae 2 Ce statement by connecting them with semi-colons.— Line 70 
: | | ee /" "initializes the variable °S which Is used forthe current 
eae | : | 3 8k srgbshot number. Lines 100-150 are the animation code,” Line 
BO ae ee a. . Pol D1 Daupdates the current. snapshot nurver. “There are 10 aa 


ae ae oY ce hea: ea , ; Vert and itl 44 ae ee NN the : se A ofc OM 
“snapshots tn each rotation of the cube as it moves across the —; 
LGAs AMER. oo) ipa cA Ey RN RMR, Pia CP 
- ye ae ‘ ‘ So ge a, C ; : \ Maer ih a athe 4 } E Bs ‘ : , 4 é eh soe a « 
ed | ‘ Ms bs Natkh, Mie ane 
- ae . ss wl ve ‘e ee HATS cae er mace eres 
vt 2% ee : ane . P 4 ere id 
var SE a ea POH : seine it ao: a ieee Tei a 
AGE ae as : ge: ig hd ak ak ST ape A. is ets 4 ras * ° 


es ae ct, eaegehs i ASR Pentel | eee i Re EERE BARBIE ae RE i jeu RS 
ey . | eee 
screen. Line iz0 i cua thie “sprite” actor. at the bbe: cr the 

screen. Line 130 draws'the "block" actor at the center of 


the screen, Notice the black outline around the block actor. 

Line 140-"flips” the viewing page and drawing page so that. 

you see the page last. drawn. This line also prepares the new 
drawing page by restoring the background where the old | 
snapshots were drawn. Use [CTRL- oie to exit: this hy 
program,’ : : 


Femieoel 


PAGE FLIP 0 RESTORE. 


This ts just ike the last program. Sheet that the 
background is not restored on each BS celal Line: 140 does ret 
have the: SRESTORE ‘command. ‘ 


10 & NEW; HIMEM 

20.8 BK LOAD “CUBES, A$6000" 

30 &B BACKIZ3: 

40 & AC LOAD “NLOCK CUNES, A$Gcooo” 

56 & AC LOAD “SPRITE CUBES"; ° 

GO & NORMAL; FULL; VIEWL; PAGE2 

70S 20. 

100 FOR X = -40 TO 280 STEP 4 

110 S « S.# 1: 1F2S « 11 THEN S’a I 
120 & DRAW S,2 AT X,10 

130.8 ORAW S,1 AT X,90 os 

140 $ FLIPS he ve 

150 REXT & ae 

160 GOTO 100. 


This program runs Se teRt ly faster than the last example but 
look at vet happens as the we ors move across the screen. 
The “sprite” leaves a; th aby of the previous snapshots. This 
might be used @@ ¢ an! in resting special effect, ‘ Meanwhile, % 
the black border “on the ;Oliock" actor erases the. old agpPshot 


we: and everey ay else. in, its path. ee Jey: “sage 
* SINGLE PAGE AK ae 
i In this example. all of the animation is done on bi-res 
ae page | with basher ogg. restore on each frame.” « ‘ 
10 8 NCW: HIME, 
270 & OX LOAD “CUBES, Aycooo". 
30 BACKI:; COPY | 7D 3 


b 
& 
& < 
40 & AC LOAD "BLOCK CUBES, A$6000" 
50 & AC LOAD “SPRITE CUBES"; | : : ae 
60 8 HORHAL 3 FULLS VIEW); Pie 

10:5 « 07 Soe 


100 FOR x 2 40 10 260 STEP i 


PI Bate EPR ON. say i ago ' ' ‘ : ‘ 
bgt LRT BL Say ye, er Ary fg i eke pF me) oat hey ‘ : f ‘ B al i 

Sey ote wh el Sea ‘ . WT RP Rta diay Bee Ste te yen ¢ . Oe tr , AAAs 4 
iy bi 


HoS«*S +. And S| = Vy THEN s = I Bee EP A dglics ae 
e048 DRAW $. 2: AT X10 : Beatie ie 
130 & ORAW S, 1 AT X90. 
140 & RESTORE iat on eras 


150 NEXT ee ee - 
160 GOTO 100 ae oo : 
Line. 30 aatodes the beckgroued to hi-res page | and then 

‘copies it to the restore page 3. Line 60 sets. both the 
‘viewing and drawing page to: hi-res page 1. Line 140 erases 
‘the snapshots and restores the: background. Without ed 
“page-flipping, everything that is done to the screen is. 
‘visible. Notice how the restore-draw cycle creates an 
objectionable "Flicker" in the animation. Try changing Line 
“30 to ACLEARI;CLEAR3 and rerun the program. Against a black 
background, the flicker jis somewhat less offensive. 


SINGLE PAGE NO RESTORE — Us in 


This program uses only hi-res page 1 with no restore cycle. 2 


: 10 & NEW; HIMEM 
20 & BK LOAD “CUBES, A$6000" 
: 30 & BACKI 3 
- «4 & AC LOAD “BLOCK CUBES, A$6000" 
50 & AC LOAD "SPRITE CUBES"; 
- 60 & NORMAL; FULL; VIEWI; PAGE! gt ae 
705 20 ree s 


100 FOR X = -40 TO 200 STEP 4.9? 
10S = S + 148 S «1 THEN'S i 
120 & ORAW S.2 AT? X10, 
130 & DRAW S/T AT'X.90. 
a ee! 180 NEXT ea he ey 
en AGO GOTO 100% : . : ; ag 


With the restore cycle eliminated, the flicker is : em 
‘eliminated even though the animation. is done on one hi-res - i. 
page. If the animation is done using a black background, 
the "block" actor produces acceptable Haat hela! | because. of 

the: self-erasing border. | : 


ae ae Lo: a Coen ee UU eae ern a ie ' 

Beg Ge Brees uh eo I Ba: gic ities Mest GBS 2 ya oe 

: ‘ “Ny i. res ra alt tees nN Tay 

ie Botte 0 ON ASC. conmaid Is. one of. the oie ‘powerful “TOOLKIT 

4 ‘te “BASIC: ‘commands. One of ‘the ‘things that slows down BASIC | 

Se eprpgrens . 4s ithe large. number of oh dee THEN statements required : 
Rah tO Interpret: keypresses. aA ‘your program uses” ‘tots of. ae» 1 
i on ae keyt 30 rd! input, - the. ON: ‘ASC: “command can’ shorten’ your pPecerene 
ae Gheaeong Teer aely: 4 white: Improving. performance. irik : 
ON OS ee ae cance feo x | Pea cies a 

Rie ih te : igen ae eee é: 

ae aye Hy oe oe smarty: moti PP OBE ci ee wet gece aah Naha 


10 LiOH KEC 33.704.75.77 GOSUB: 109,200,300, 400 


‘RTERACTIVE CUBES 


I 


ie 20 GOIO 10. : : ; 
mee pod PRINT TLE This program allows full contro! «% ¢ :9 different size ees 
~ 200 Pept “LEtT"s ROU rotating cubes directly from th... ao Ane sek Oe ee | 
+ 300 FRINT "RIGHT": RETURN WM keys control the small cube anc wit A, W. Se and Z Keys — pe 
fe 400 FRINT “DORN: RETURN control the big cube... Each keypress adds directional ; a 
Re . ee | : : ; *thrust™ to the cube as if it were drifting in space. By a 
Geet je Line (Oe Ane Petit womers for the 1, J. K,. and H keys carefully manipulating the keys, you can move the cubes .in Oly 
* 4 pee chown. Lf one of (nese keys Is pressed, .the program any direction, speed them up or stow them to a stop. Ae, 
re will wosvd to the apprep iate. subroutine at Lines 100-400. : e aS 3 , eb 
ue a .. oy The program uses several techniques to speed up BASIC ay 
ee execution. The most important is the use of variables — ee | 
e / rears DChy instead of tonstants in the animatian loap. The program also Re, 
ae | Be uses indexed arrays to update screen positions and snapshot 4a: 
fe Noi this program is simiiar to the SPACE DEMO program shown in numbers. This is much faster than incrementing by addition. ont 
< Chapter 1 Instead c” running the scene, the program allows Another trick to speed up BASIC is te put the time critical i - 
% . frame-by-freme control of the scene using the left and right (animation) routines near the beginning of the program and rege 
ee @rrow keys. : ee : the initializing code at the end. oY 
. 16 & BK LOAN "SPACE STATION, A$6000" | aa 
Us sae BieKIPS SOUND FH PROGRAM | 
e 30 & SN LOAD “SPACE STATION, AgG000" . 
£0 E VIEW Li 8 PAGE He a The SOUND FN PROGRAM allows you to exndriment with 
60 F = 1: 8 FRAME F | i different sounds that can be created,tising the SOUND FH 
62 8 OW ASC 6,2! GOSUB 100,200 command: When you run this prograns you will be promoted to 
[6 GOTO 60°—:. : enter values for the pitch and <hiration parameters used in 
100 IF Fee THEN RETURN ze the SOUND FI comnsand. For geen pitch or duration value, 
ee _ type a nuimber from 0 to 2)5-and press (RETURN). Up to 10° 
170.8 FRAME Fa SOUND O ye pitch-duration nai eyfint be entered. khen you are finished, 
130 RETURN - Dag press (RETURN) Moaw ithout entering any nu:nzer. You will 
200 IF F = 154 THEN RETURN see the SOUNDAN cGgiiand as it would appear in your own 
oO Rae ee = program, TheA.pe SEAL SPACE } to heor the sound. 
220 & FRAME 3.6000 0. : | 
230 ef a : An infinite variety of sounds can be created using the 
S et via o; | athe: | SOUND.FN comnand but It can take some experimenting to create 
; Lines 10-30 load the ,bockground snd scene fties. Line the complex sounds. Values between 5 and 100 seem to work 
ae displays the hi-res “screen. Line 50 initializes the “frame : best for the pitch ‘and curetion poreantery,:: 
ae Me net F and agp ers that framo. tines 60-70 are a loop 
a using the ON AS Feonrand to look for a left-arrow keypress Se 
Een B) or right-arrow keypress (ASCII 24). Tf one of CREATING HI-RES KEIUS : 
oe eee khevs is pressed: the. program wil! branch te Line 100 mS : | . 4 
ee tee ys Ne - to Line 200 to increment Ge When you Boot te shila AE) wediegs date sh una 
oe the frame number. With each frame a “click” is heard from | th title screen appears Followed by the main mend This hi-res 
the BESOUHD commend. «a. | oy, c ty menu is. the HELLO program on the disk and can be easily 
ae : whe | ; ele : modified for use in your own programs. This particular menu 
ee - es has only two options but the program can have any number -of ts 
ae options selected by the arrow keys. . You can choose any of rh 
: ag a ~ i. the Baudville Character Sets for the hi-res text by changing ies 
a t o™ 4. the Filename in Line 40. To customize this program for: your ‘a 
i: eS 4 EE OWN USE, just change the DATA statements starting at Line e 
ae er EODOUt ec EPR Rs Seis eae : an : 
# ee rh a A MO oe Ceuta oa. Adee 
mae : os 
RES coment mee aos ae rk 5 peek ee es pe Nene ae 
- . ia ae 


ae 
‘ bye DA a 
‘ feat GR hoo he a Pcrmatter” . sh eVe5 
‘SACP OATA “iwtt co Unsie! Ge.lid 
1nC30 DATA “ier crrow keys and Return 
hes $0 7CRL eee 107 
Tm TPTR et atosent of 1 ioe PO0L0 hes thi ee parameters. Tw 
ae. oi.) pepemater 1$¢ Liseonucmcr Of menu options to be displayed 
‘ fin itis tase 2). “Menu options ere cent lines that will be 
Wicsiayed 18 Inverse os the arron keys are pressed. The 
ae srceud parameter is the total numer of text items to be 
Cleptaved. This fucluces the menu options PLUS any other 
) text tines that are mut a.ected by the arrow keys. The 
\ titrd parometer is the helght of the capital letters in the 
{ a 
chia rhs ler: Set. Z eQ° 
Ps eget 
The CATA statements starting at Lfy¥e 10010 are the actual 
mes - text iterns to be displayed. Thes¥ormat of each DATA 
: atatement Is: "Text in quotes$@x-coordinate, y-coordinate. 
The menu options are listed sFirst. In the order you want thein 
fe tc be selected by the arcow keys. Any other text items are 


Isted after the menutoptions. 
liste t | iis ee 


You willl have to“fut) In your own code starting at Line 5009 


“to tell the program what to do once a menu item has been 


selected. The variable S Js the current option number when 


[RETURN] Js presseds me 
- Me : 


“ 
we 
ae 


